home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / writions / boxer50b / readme.2nd < prev    next >
Text File  |  1993-04-06  |  10KB  |  249 lines
  1.  
  2.         ------------------------------------------------------
  3.         This file contains answers to commonly asked questions
  4.         ------------------------------------------------------
  5.  
  6. If you have a laptop computer and have trouble with BOXER's default color
  7. settings, this may be because your video card announces itself to be color,
  8. but your screen is monochrome.  Issue the following DOS command:
  9.  
  10.                COPY MONO.CLR DEFAULT.CLR <Enter>
  11.  
  12. to set the monochrome color file to be the default.  You may later wish
  13. to use the Set Colors command to select suitable colors for your screen.
  14. Alternatively, you may use the -n option flag to force monochrome output.
  15.  
  16. ----
  17.  
  18. On computers with AT keyboards, BOXER sets the keyboard repeat rate to
  19. the fastest setting upon entry to the editor.  This contributes to the
  20. fast screen scrolling you see in BOXER.  Because the repeat rate can be
  21. set, but not read, BOXER sets the rate to normal upon exit.  If you wish
  22. for the fast rate to persist after exiting, add the -kx flag to the
  23. BOXER environment string.  If you prefer a different repeat rate,
  24. experiment with various values with the -kd and -kr options.  If you
  25. prefer that the keyboard rate not be changed at all, use the -k0 option.
  26. A full display of these and other options can be seen by doing "B -?".
  27.  
  28. ----
  29.  
  30. The default macro set supplied with BOXER includes a macro to spawn an
  31. external spell check utility to operate upon the current file.  As
  32. supplied, the macro will run with ShareSpell, if present on your system.
  33. (See REGISTER.DOC for notes about receiving an evaluation copy of
  34. ShareSpell.) The macro can be easily edited or re-recorded to run other
  35. spell checkers, or any other text-filtering utility.
  36.  
  37. The macro makes use of the DOS Shell command to name the utility to be
  38. run, and the "%1" sequence which expands to the name of the current file
  39. being edited.  Macro keys are not stored within the DOS shell, so the
  40. macro must be terminated upon return to BOXER.
  41.  
  42. This is the macro as supplied:
  43.  
  44.     <macro=S><name=spell check>
  45.     <write file><DOS command>ss<space>%1<enter><enter><enter><reload>
  46.     <start of line><enter>
  47.  
  48. This same macro technique can be used to smoothly integrate other utility
  49. programs with BOXER.
  50.  
  51. ----
  52.  
  53. Though BOXER cannot be installed directly to a 360K floppy, it is possible
  54. to create a diskette on another machine which contains the files needed for
  55. editing on a single 360K floppy drive system.  Create the "BACKUP" directory
  56. on the floppy and copy the following files to the root:
  57.  
  58.                B.EXE, BOXER.DOC, BOXER.IDX and DEFAULT.*
  59.  
  60. The BOXER executable B.EXE is in fact fully self-contained.  The additional
  61. files are needed only if you desire online help or custom- screen colors,
  62. macros, print parameters or key assignments.
  63.  
  64. ----
  65.  
  66. Upgrading from previous versions...
  67.  
  68. During installation, you were offered the chance to use existing DEFAULT
  69. files from a previous installation.  When appropriate, the files from
  70. the new release have been installed as NEWDFLT.*, leaving the old files
  71. with the name DEFAULT.*.  In this way you can decide whether to use the
  72. new default files, or your own.
  73.  
  74. If you are upgrading BOXER from a prior release and intend to use your
  75. old .KEY file(s), you will need to run RECONFIG to assign keys to the
  76. new commands added in this version.  See RECONFIG.DOC for details.
  77.  
  78. ----
  79.  
  80. Q. Why don't ASCII characters in the range 240-249 display as expected?
  81.  
  82. A.  By default, BOXER uses ASCII characters 240-249 to represent
  83. embedded printer codes.  These appear on screen as specially colored
  84. digits to distinguish them from neighboring text.  Embedded printer
  85. codes provide a shorthand method of accessing various features of
  86. your printer without placing long sequences of printer codes
  87. directly in the text file.  See Section 18 in the help file for more
  88. information.
  89.  
  90. To configure BOXER to display these values normally, do one of the
  91. following: From within the editor, use Ctrl-F3 or the Printer Codes
  92. option in the WP menu to disable embedded printer codes.  If you
  93. prefer, the -e option can be placed in the "BOXER" environment
  94. string to make the change permanent.  The -e option can also be used
  95. on the command line, or in a batch file that calls BOXER.
  96.  
  97. ----
  98.  
  99. The information about Compiling from within BOXER which appeared here
  100. has been moved to DEFAULT.CFG.  BOXER can now be configured to select a
  101. compiler based on the extension of the file being compiled.
  102.  
  103. ----
  104.  
  105. You can install BOXER as a Transfer item in the Borland IDE making it
  106. easy to jump into BOXER for source file editing.  Select the "Transfer"
  107. option in the C IDE (or the "Tools" option in the Pascal IDE) with
  108. <Alt-O><T>.  Edit an existing entry to name BOXER and its path (usu.
  109. C:\BOXER\B.EXE).  Enter the following text for the command line to
  110. invoke BOXER:
  111.  
  112.                   $SAVE CUR $MEM(640) -g$LINE $EDNAME
  113.  
  114. After selecting a Hot Key, select the New box to create a new Transfer
  115. item.  Finally, select OK to save the setup.
  116.  
  117. This IDE macro will give BOXER the needed information to place you on
  118. the same text line as in the IDE.  With this configuration, you'll be
  119. able to quickly switch to BOXER from within the IDE - return to the IDE
  120. is automatic upon exiting BOXER.
  121.  
  122. ----
  123.  
  124. Paradox users can install BOXER within their development environment so
  125. the editor can be used to easily correct program errors.  Use the Paradox
  126. configuration feature to specify the path to BOXER, and the command line
  127. option which will jump to a given line number.  For example:
  128.  
  129.                     C:\BOXER\B.EXE * -g**
  130.  
  131. Paradox will insert the filename in place of '*' and the line number in
  132. place of '**'.
  133.  
  134. ----
  135.  
  136. AutoCad users can designate BOXER as their editor of choice by making
  137. an entry in the ACAD.PGP file.  See your documentation for complete
  138. information, but an entry such as that below should be sufficient:
  139.  
  140.                       BOXER,B,640,File to Edit,4
  141.  
  142. ----
  143.  
  144. U.K. note:  The Ctrl-@ sequence is attainable on UK keyboards as Ctrl-2.
  145.  
  146. ----
  147.  
  148. An incompatibility has been found between BOXER and Ultravision 2.0 by
  149. Personics, when used with the Microsoft MOUSE.COM v7.04.  It seems that
  150. the Ultravision mouse driver creates a conflict which causes BOXER to
  151. hang upon mouse initialization.  Earlier MOUSE.COM versions work fine.
  152.  
  153. ----
  154.  
  155. Earlier versions of BOXER required the use of the -d option to specify
  156. the editor's home directory.  This option is no longer required for
  157. users with DOS v3.x or better, and so can be removed from the "BOXER"
  158. environment variable.  You would only need to use this option now if you
  159. decide to keep the BOXER executable in a directory other than the home
  160. directory, or if you are using DOS 2.x.  (NOTE: if used, this option
  161. must appear in the "BOXER" environment string.  It cannot be placed in
  162. the file DEFAULT.CFG, as can all other option flags.)
  163.  
  164. ----
  165.  
  166. DR DOS Users: there is an incompatibility between BOXER's DOS Shell and
  167. Compile commands and the EMM386 driver in DR DOS.  In order to use
  168. BOXER's swapping feature, you will need to disable access by the driver
  169. to the Upper Memory area.  DR DOS provides a utility for just this
  170. purpose.  To disable access, run the following command: MEMMAX -U
  171.  
  172. If you need access to the Upper Memory area at other times, you might
  173. prepare a batch file to disable/enable memory access as follows:
  174.  
  175.                     MEMMAX -U
  176.                     B %1 %2 %3 %4 %5 %6 %7 %8
  177.                     MEMMAX +U
  178.  
  179. ----
  180.  
  181. DESQview Tips: you may wish to configure "ticks" to 15/1 or 30/1, when
  182. not downloading, to get smoother mouse and cursor movement.  The mouse
  183. driver should be loaded before entering DESQview.
  184.  
  185. When using DESQview's Mark and Transfer function, set BOXER's auto
  186. indent option to OFF to ensure that each line in the block transferred
  187. begins in the same column.
  188.  
  189. You may experience "mouse droppings" if you use BOXER with DESQview and
  190. have an old mouse driver.  Microsoft's driver v6.14 shows this symptom,
  191. while versions 7.04 and later do not.
  192.  
  193. ----
  194.  
  195. On some computers, and in certain video modes, BOXER's text cursor has
  196. been reported to be invisible.  If this happens try using the "-8"
  197. option flag to specify that no changes should be made to the cursor
  198. size.  Also, toggling between 43/50 line mode and 25 line mode has been
  199. found to be a workaround.  The following macro, recorded as a startup
  200. macro, will automate the use of this workaround.
  201.  
  202. <macro=[><name=>
  203. <toggle video mode><right><right><enter><toggle video mode><left><left>
  204. <enter>
  205.  
  206. See BMAC.DOC for details on how to create and edit the DEFAULT.M macro
  207. file.  The invisible cursor problem is under investigation.
  208. ----
  209.  
  210. On some laptop computers, there are no keyboard equivalents for the - +
  211. and * keys found on the numeric keypads of full size keyboards.  By default,
  212. BOXER uses these keys for marked text manipulations, so you may wish to
  213. use RECONFIG to select alternate keys for these commands.
  214.  
  215. ----
  216.  
  217. Programmers: if you would like help in making your program more friendly
  218. for blind users, contact Jeff Bishop.  Jeff is developing a set of guide-
  219. lines called the Braille and Speech Friendly Interface (BSFI).  You can
  220. write to Jeff for details: 420 E. Yavapai Road, Apt H, Tucson, AZ 85705.
  221.  
  222. ----
  223.  
  224. I heartily recommend this book to aspiring authors:
  225.  
  226.  
  227.     If you're considering launching a shareware product, you need:
  228.  
  229.                             The ShareWare Book <ASP>
  230.  
  231.                  A Whole Earth Catalog for software developers
  232.  
  233.     Tips, tools and techniques for successful shareware marketing and
  234.     development.  Includes market research, publicity, getting paid,
  235.     distribution, resources, product protection, registration encouragement,
  236.     trademarks, copyrights, licensing, channel management, business issues,
  237.     support, taxes, manuals, packaging, shipping, international trade.
  238.  
  239.                   "Everything an author needs to get started"
  240.  
  241.         Look for ShareB.EXE in CIS SHARE lib 0 or ShareBk*.zip on BBSs.
  242.  
  243.                                By Robert Schenot
  244.                              Compass / New England
  245.                                  P.O. Box 117
  246.                            Portsmouth, NH  03802-0117
  247.                                  (603) 431 8030
  248.  
  249.